Tutorial: Creating a toggle button

In this tutorial you learn how to create a toggle button in Kanzi Studio using the Kanzi state manager.

This tutorial assumes you understand the basics of working with Kanzi Studio. The best entry points for getting familiar with Kanzi Studio are:

This video shows the result of the tutorial.

Assets for the tutorial

The starting point of this tutorial is the Toggle button.kzproj Kanzi Studio project file stored in the <KanziWorkspace>/Tutorials/Toggle button/Assets directory.

The <KanziWorkspace>/Tutorials/Toggle button/Completed directory contains the completed project of this tutorial.

Create a Toggle Button 2D node

In this section you create and position a Toggle Button 2D node.

To create a Toggle Button 2D node:

  1. In Kanzi Studio open the project stored in the <KanziWorkspace>/Tutorials/Toggle button/Assets directory.
  2. Create and position the Toggle Button 2D node:
    1. In the Project press Alt and right-click the node where you want to create the toggle button and select Toggle Button 2D.
      For example, create a Toggle Button 2D node in the Frame node.
    2. From the Assets window drag the ToggleButtonBackground image to the Toggle Button 2D node in the Project.
    3. In the Project select the Toggle Button 2D node, in the Preview use the Node tool , and click the center square to align the Toggle Button 2D node to the center of the Frame node.

Create the toggle button states

In this section you use the state manager to define what the toggle button looks like when it is switched on and off.

To create the toggle button states:

  1. In the Project select the Toggle Button 2D node and in the State Tools click Create State Manager.
    You can find the State Tools window below the Preview window.
    Kanzi Studio creates a state manager and assigns it to the Toggle Button 2D node.
  2. In the State Tools click Create State twice to create two states, double-click the name of each state, and rename the states.
    For example, name one state On and the other Off.
    The On state defines the state of your application when the toggle button is switched on, the Off state when the toggle button is switched off.
  3. Add and position the toggle button indicator:
    1. From the Assets window drag the Indicator image to the Toggle Button 2D node in the Project.
    2. In the Preview in the Node tool click and select Render Transformation for the target transformation.
      You can apply transformations in these ways:
      • Layout transformation transforms the item before it applies the layout pass.
      • Render transformation transforms the item after it applies the layout pass, but before it renders the item.

      Always use the Render Transformation, unless you know that you have to recalculate the layout.

    3. Use the Node tool to place the Indicator node over the Off part of the ToggleButtonBackground node.
      TIP

      You can adjust the Preview zoom level in the upper right corner of the Preview.

      TIP

      When dragging a node in the Preview, use the Snap tool to snap the size or position of that node to the nearest coordinates of another node.

  4. In the State Tools click in the On state to save the current position of the toggle button indicator to that state.
  5. In the Preview select the Node tool and click to disable snapping to nodes and guides.
    When you disable snapping, you can use the Node tool to move a node in the Preview so that it does not snap to nodes or guides.
  6. In the Preview use the Node tool to position the toggle button indicator over the On part of the ToggleButtonBackground node.
    TIP

    Hold down the Shift key when you drag a node with the Node tool to move the node in a true horizontal or vertical line.

  7. In the Project select the Indicator node and in the Properties set the Image property to the IndicatorOff image.
    Here you set what the toggle button indicator looks like when the toggle button is in the Off state.
  8. In the State Tools click in the Off state to save the current position of the toggle button indicator to that state.
  9. In the State Tools click the <No Controller Property> dropdown menu and select the Button > Toggle State property.
    In a state manager the value of the property you select as the Controller Property defines the conditions when each state in a state group is active.
  10. In the State Tools set the value of the controller property for each state.

  11. In the State Tools click Edit State Manager to deactivate the State Tools.
  12. In the Preview click to enter the Interact mode. When you click the toggle button in the Preview you toggle between the On and Off states you defined in the state manager that you created in the Toggle Button 2D node.

What's next?

In this tutorial you learned how to create a toggle button. Now you can:

See also

To learn more about the Kanzi state manager, see State manager.

To learn more about different types of button nodes and how to use them, see Buttons.

To learn more about creating Kanzi applications, see Tutorials.